Apply a patch by Guillaume Cottenceau to improve the signal docs.

2007-07-16  Matthias Clasen <mclasen@redhat.com>

        * gtk/gtkscalebutton.c: Apply a patch by Guillaume Cottenceau
        to improve the signal docs.  (#456258)

svn path=/trunk/; revision=18475

diff --git a/ChangeLog b/ChangeLog
index 449ce3c89970404caae91d5f5989769fc3d19b10..638bb8ea2cd2100bfd9bc6822b20d277cde76c82 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-07-16  Matthias Clasen <mclasen@redhat.com>
+
+       * gtk/gtkscalebutton.c: Apply a patch by Guillaume Cottenceau
+       to improve the signal docs.  (#456258)
+
 2007-07-16  Matthias Clasen <mclasen@redhat.com>
 
        * gtk/gtkwidget.c: Apply a patch by Xan Lopez to document

diff --git a/gtk/gtkscalebutton.c b/gtk/gtkscalebutton.c
index e6beb18f4afc3f6eb1a8a7d700456b222a1633bb..4de34dd15bc5b584c6100768b7fc26d3e8477992 100644 (file)
--- a/gtk/gtkscalebutton.c
+++ b/gtk/gtkscalebutton.c
@@ -230,15 +230,16 @@ gtk_scale_button_class_init (GtkScaleButtonClass *klass)
                                                        P_("List of icon names"),
                                                        G_TYPE_STRV,
                                                        GTK_PARAM_READWRITE));
+
   /**
    * GtkScaleButton::value-changed:
-   * @button: the object that received the signal
-   * @value: The new value
+   * @button: the object which received the signal
+   * @value: the new value
    *
-   * Emitted when the value field has changed.
+   * The ::value-changed signal is emitted when the value field has
+   * changed.
    *
    * Since: 2.12
-   *
    */
   signals[VALUE_CHANGED] =
     g_signal_new (I_("value-changed"),
@@ -249,6 +250,18 @@ gtk_scale_button_class_init (GtkScaleButtonClass *klass)
                  _gtk_marshal_VOID__DOUBLE,
                  G_TYPE_NONE, 1, G_TYPE_DOUBLE);
   
+  /**
+   * GtkScaleButton::popup:
+   * @button: the object which received the signal
+   *
+   * The ::popup signal is a 
+   * <link linkend="keybinding-signals">keybinding signal</link> 
+   * which gets emitted to popup the scale widget.
+   *
+   * The default bindings for this signal are Space, Enter and Return.
+   *
+   * Since: 2.12
+   */
   signals[POPUP] =
     _gtk_binding_signal_new (I_("popup"),
                             G_OBJECT_CLASS_TYPE (klass),
@@ -257,6 +270,19 @@ gtk_scale_button_class_init (GtkScaleButtonClass *klass)
                             NULL, NULL,
                             g_cclosure_marshal_VOID__VOID,
                             G_TYPE_NONE, 0);
+
+  /**
+   * GtkScaleButton::popdown:
+   * @button: the object which received the signal
+   *
+   * The ::popdown signal is a 
+   * <link linkend="keybinding-signals">keybinding signal</link> 
+   * which gets emitted to popdown the scale widget.
+   *
+   * The default binding for this signal is Escape.
+   *
+   * Since: 2.12
+   */
   signals[POPDOWN] =
     _gtk_binding_signal_new (I_("popdown"),
                             G_OBJECT_CLASS_TYPE (klass),